Type: concept
Confidence: 0.75
Created: 2026-04-25
Updated: 2026-04-25
Tags: version-controldocumentationskills-managementAI工程

ERRATA 机制

概述

jezweb/claude-skills 项目中的版本变更管理机制,用于处理库更新导致的技能内容过时问题,通过分离核心内容和版本变更记录来保持技能内容的稳定性。

关键内容

  1. 设计原理:当库更新导致技能内容过时时,不立即修改 SKILL.md,而是创建 ERRATA.md 文件记录变更,保持核心内容稳定。

  2. 文件结构

  3. SKILL.md:核心内容(稳定,少改动)
  4. ERRATA.md:版本变更记录(活跃更新)
  5. REFERENCE.md:参考资料

  6. 状态生命周期:ERRATA 记录有三种状态 - active(当前有效的纠正)、absorbed(已合并到 SKILL.md)、outdated(库再次变更,记录已过时)。

  7. 优势:提供即时的错误修正能力,同时保持技能内容的稳定性,避免频繁的文档更新造成混乱。

  8. 应用场景:特别适用于快速发展的前端生态,如 Tailwind CSSReact 等库的频繁更新。

来源

相关